home *** CD-ROM | disk | FTP | other *** search
/ Mars Digital Image Map / Mars Digital Image Map - Disc 1.iso / software / sun / softinfo.txt < prev   
Text File  |  1991-09-06  |  6KB  |  162 lines
  1. CCSD3ZF0000100000001NJPL3IF0PDS200000001 = SFDU_LABEL
  2. RECORD_TYPE                    = STREAM
  3. PRODUCT_CREATION_TIME          = 1991-08-06
  4. OBJECT                         = TEXT
  5.    NOTE                        = "Description of the Sun software
  6.                                   provided with the MDIM CD-ROM set"
  7. END_OBJECT                     = TEXT
  8. END
  9.  
  10.          UNIX/SUN SPARCSTATION WITH OPEN WINDOWS 2.0 INTERFACE
  11.          -----------------------------------------------------
  12.  
  13.  
  14. Although the software contained on this CDROM have been used and tested,
  15. no warranty, expressed or implied, is made by NASA, the Jet Propulsion
  16. Laboratory (JPL), or the United States Geological Survey (USGS) as to
  17. the accuracy and functioning of the software and related materials, and
  18. no responsibility is assumed by NASA, JPL, or the USGS.
  19.  
  20.  
  21. HOW TO INSTALL:
  22.  
  23. 1. Create a sub-directory to install the PDS map reader software.
  24.    mkdir  <sub_directory_name>
  25.  
  26. 2. Change directory into the sub-directory just created.
  27.    cd  <sub_directory_name>
  28.  
  29. 3. Copy the appropriate software from the SOFTWARE.SUN directory.
  30.    
  31.    **** THE SOFTWARE ELEMENTS TO COPY *****
  32.  
  33.    reader.bin    executable
  34.    software.txt    this document
  35.    gray.pal    grayscale color map
  36.    mars.pal    pseudo mars color map
  37.    openwin.pal    optional grayscale color map with a bit of the 
  38.                 OpenWindow 2.0 default colors (to avoid color map 
  39.                 flicker) 
  40.  
  41. SYSTEM REQUIREMENTS, RUN TIME and BUGS:
  42.  
  43. 1. To run this software you need a Sun SparcStation with
  44.    OpenWindows 2.0 (It may work with OSF/Motif).
  45.  
  46. 2. The S/W was developed using OpenWindows 2.0, devGuide 1.1,
  47.    and PDS Toolbox on a Sun's SparcStation 2.
  48.  
  49. 3. Exiting the OpenWindows after running this program, the console
  50.    color map is clobbered.  Use 'clear_colormap' to restore the default
  51.    console color map.  I don't know what causes this.
  52.  
  53. 4. The program has been tested on the 8-bit MDIM but not for 16-bit
  54.    DTM.
  55.  
  56. 5. This software is not supported and it is distributed as it is.
  57.    Use it at your own risk.  If you have any comments, improvements,
  58.    or bug reports, please e-mail to:
  59.       
  60.     min@trantor.jpl.nasa.gov or
  61.  
  62.     US mail to
  63.  
  64.     Min-Kun Chung, M/S 301-142
  65.     Jet Propulsion Laboratory
  66.     4800 Oak Grove Drive
  67.     Pasadena, CA 91109
  68.  
  69.  
  70.  
  71. HOW TO USE THE PROGRAM:
  72.  
  73. 1. Just type in "reader.bin"  The optional parameters are as follows:
  74.  
  75.    reader.bin <pds_map>  <color_map>  <stretch_fraction>  <byte_order>
  76.  
  77.    <pds_map> is the PDS digital image map name. i.e. mi70n135.img
  78.    The default is no map when first loaded.
  79.  
  80.    <color_map> is the color map file name. i.e. gray.pal
  81.    A color map file is an ASCII text file with a series of
  82.    4 number columns.  The structure of the file is as follows:
  83.  
  84.    color index      red      blue      green
  85.  
  86.    For example, a gray scale map will look as follows:
  87.  
  88.               0      0      0      0
  89.               1      1      1      1
  90.               2      2      2      2
  91.               .      .      .      .
  92.               .      .      .      .
  93.               .      .      .      .
  94.             254    254    254    254
  95.             255    255    255    255
  96.  
  97.    The default is the gray scale color map.
  98.  
  99.    <stretch_fraction> is the fraction of the color to ignore from each
  100.    end, low and high.  The histogram data on the PDS header is
  101.    used to set STRETCH LOW and STRETCH HIGH value using this
  102.    stretch_fraction value.  The default is set to 0.000025.
  103.  
  104.    <byte_order> is to indicate the 16-bit DTM data is in Sun short
  105.    integer format.  This requires no byte swapping on the Sun.
  106.    The default assumes the 16-bit data is in VAX format,
  107.    and requires byte swapping.
  108.  
  109. 2. The program opens a window titled "PDS MAP DISPLAY."  The functions
  110.    in this window are as follows:
  111.  
  112.    Typing in the PDS map name to load and clicking the LOAD
  113.    button loads the PDS map.  Typing in the map name to load and
  114.    typing return does the same thing.  If the map name typed in is
  115.    a directory (or a blank), then a directory browser is popped up.
  116.    The (current) directory is listed in the DIRECTORY of the directory
  117.    browser.  An optional filter may be specified in the
  118.    FILTER such as *.img.
  119.  
  120.    Clicking once on an entry of the file name list popup
  121.    displays the name on the map name entry item.  Then the LOAD
  122.    button can be pressed to load the map.  Double clicking on the
  123.    map name entry of the popup list also loads the map.
  124.  
  125.    Typing in the zoom factor and clicking the ZOOM button
  126.    zooms the current map by that factor.  Typing in the factor
  127.    and typing return also does the same thing.
  128.  
  129.    Clicking on the COLOR button opens a color control pop window.
  130.  
  131. 3. When a new map is loaded, the 8-bit histogram is examined along with
  132.    the <stretch_fraction> parameter, and the color map is stretched (or
  133.    the STRETCH LOW and HIGH values are set) to give a better contrast
  134.    automatically.
  135.  
  136. 4. The PDS COLOR MAP CONTROL window allows a manual color control.
  137.  
  138.    Typing in the colormap name and clicking on the LOAD button
  139.    loads the desired color.  See above for the format of a color
  140.    map.  "gray.pal" and "mars.pal" colormaps are provided.
  141.  
  142.    On the COLOR MAP CONTROL window is a wide color bar.  This
  143.    shows all 256 colors allocated to the map.  The left most
  144.    position is color index 0 and the right most position is color
  145.    index 255.
  146.  
  147.    The CYCLE slider shifts the color map.  For example, cycle 100
  148.    will cause the original color index 0 to be changed to color
  149.    index 100.  CYCLE can be set more easily by clicking the middle
  150.    button with  the cursor on the color bar canvas.
  151.  
  152.    STRETCH LOW and STRETCH HIGH enable color stretch.  For
  153.    example if the LO value is 50 and HI value is 200, then the
  154.    original color index from 0 to 255 is re-scaled to fit from
  155.    50 to 200.  STRETCH LOW value and STRETCH HIGH value can be
  156.    set more easily by clicking on LEFT and RIGHT mouse buttons
  157.    with the cursor on the color bar canvas.
  158.  
  159.    Clicking on the RESET button resets the CYCLE to 0,
  160.    STRETCH LOW to 0, and STRETCH HIGH to 255.
  161.  
  162.